Polish translation of the Scala tutorial #652

adam-wyluda · 2017-01-10T10:56:12Z

This is a complete translation of the Scala tutorial into the Polish language.

heathermiller · 2017-01-10T10:58:08Z

Whoa! Yes! Another translation!! 😄
Thank you so much!

By any chance, is there anyone you could suggest that would be able to review this translation?

…everal minor corrections

Krever

Great work! Polish community should be really grateful for this. I left small comments about particular wording or translations but nothing really big.

I didn't have time to read it twice, so I think at least one more reviewer should take part in it.

Krever · 2017-01-11T07:42:49Z

pl/tutorials/tour/case-classes.md

+tutorial-previous: currying
+---
+
+Scala wspiera mechanizm _klas case_. Klasy case są zwykłymi klasami z dodatkowymi założeniami:


Does this translation of case class has previously appeared anywhere or has been discussed? I know it is very hard to translate such names, but klasa case doesn't sound very well. Sadly, I don't have any obviously better one. Klasy przypadków has been used here: http://www.scala-lang.org/docu/files/ScalaTutorial-pl_PL.pdf and I think it sound a little better, but still not perfect...

Right, klasy przypadków sounds more natural. I wasn't sure if I should translate terms that are unique for Scala, but if it was translated before then I guess we should use this term.

Krever · 2017-01-11T07:46:17Z

pl/tutorials/tour/case-classes.md

+
+Scala wspiera mechanizm _klas case_. Klasy case są zwykłymi klasami z dodatkowymi założeniami:
+
+* Domyślnie immutable


I have met pretty good translation of immutable to niemutowalny or (slightly worse in my opinion) niezmienny. Is there a reason to use english word for this?

immutable or niezmienny seems to be commonly used on Polish forums, but niemutowalny sounds very nice, I think we can use that instead.

Krever · 2017-01-11T09:18:07Z

pl/tutorials/tour/generic-classes.md

+}
+```
+
+Klasa `Stack` modeluje zmienny stos z zawierający elementy dowolnego typu `T`. Parametr `T` narzuca ograniczenie dla metod takie, że tylko elementy typu `T` mogą zostać dodane do stosu. Podobnie metoda `top` może zwrócić tylko elementy danego typu.


Redundant z in stos z zawierający

Krever · 2017-01-11T09:33:21Z

pl/tutorials/tour/implicit-conversions.md

+tutorial-previous: implicit-parameters
+---
+
+Konwersja implicit z typu `S` do `T` jest określona przez wartość implicit, która jest funkcją typu `S => T` lub przez metodę implicit odpowiadającą funkcji tego typu.


Similar case like with klasy case. Have you considered translating implicit? I think people tend to use niejawne for this.

I thought about this, but niejawne in Polish suggests something that is just opposite of explicit. This might work for implicit conversions, but for implicit parameters we should probably use domniemany since implicit here means more like something that is implied.

Krever · 2017-01-11T09:36:46Z

pl/tutorials/tour/implicit-parameters.md

+W poniższym przykładzie zdefiniujemy metodę `sum`, która oblicza sumę listy elementów wykorzystując operacje `add` i `unit` obiektu `Monoid`. Należy dodać, że wartości implicit nie mogą być zdefiniowane globalnie, tylko muszą być elementem pewnego modułu.
+
+```tut
+/** Ten przykład wykorzystuje strukturę z algebry abstrakcyjnej aby zilustrować działanie parametrów implicit. Półgrupa jest strukturą algebraiczną na zbiorze A z łączna (która spełnia warunek: add(x, add(y, z)) == add(add(x, y), z)) operacją nazwaną add, która łączy parę obiektów A by zwrócić inny A. */


łączna instead of łączną

Krever · 2017-01-11T10:10:22Z

pl/tutorials/tour/mixin-class-composition.md

+tutorial-previous: traits
+---
+
+W przeciwieństwie do języków które wspierają jedynie pojedyncze dziedziczenie, Scala posiada bardziej uogólniony mechanizm ponownego wykorzystania klas. Scala umożliwia na wykorzystanie _nowych elementów klasy_ (różnicy w stosunku do klasy bazowej) w definicji nowej klasy. Wyraża się to przy pomocy _kompozycji domieszek_.


In other places we use cecha as translation of trait and here it's changed to domieszka. I think cecha is much better.

domieszka is a Polish term for mixin (see Wikipedia page) which is something different than just trait.

My mistake, I haven't seen it before. Sorry :)

Krever · 2017-01-11T10:20:25Z

pl/tutorials/tour/nested-functions.md

+tutorial-previous: higher-order-functions
+---
+
+Scala pozwala na zagnieżdżanie definicji funkcji. Poniższy obiekt określa funkcję `filter`, która dla danej listy filtruje elementy większe bądź równe niż podany próg `threshold`:


filtruje elementy większe bądź równe niż podany próg

I think it should be filtruje elementy większe bądź równe podanemu progowi

Krever · 2017-01-11T10:34:50Z

pl/tutorials/tour/singleton-objects.md

+
+## Companion ##
+
+Duża część obiektów singleton nie istnieje samodzielnie, ale jest powiązana z klasą o tej samej nazwie. Obiekt singleton generowany dla klasy case jest tego przykładem. Kiedy tak się dzieje, obiekt singleton jest zwany *obiektem companion* (co oznacza, że jest _towarzyszem_ tej klasy).


We can consider obiekt towrzyszący instead of obiekt companion as it sound a bit more natural, IMHO.

I though about obiekt towarzysz which sounded a bit awkward but I like obiekt towarzyszący, I think we can use this translation.

Krever · 2017-01-11T10:37:31Z

pl/tutorials/tour/singleton-objects.md

+}
+```
+
+Bardzo powszechne jest użycie wzorca typeclass w połączeniu z [wartościami implicit](implicit-parameters.html), takich jak `ipord` powyżej, zdefiniowanych w obiekcie companion. Dzieje się tak, ponieważ elementy obiektu companion są włączone w procesie wyszukiwania domyślnych wartości implicit.


elementy obiektu companion są włączone w procesie wyszukiwania

Maybe uwzględniane instead of włączone ?

Krever · 2017-01-11T11:04:50Z

pl/tutorials/tour/upper-type-bounds.md

+tutorial-previous: variances
+---
+
+W Scali [parametry typów](generic-classes.html) oraz [typy abstrakcyjne](abstract-types.html) mogą być warunkowane przez ograniczenia typów. Tego rodzaju ograniczenia pomagają określić konkretne wartości zmiennych typu oraz odkryć więcej informacji na temat elementów tych typów. _Ograniczenie górne typu_ `T <: A` zakładają, że zmienna `T` odwołuje się jest podtypem typu `A`.


że zmienna T odwołuje się jest podtypem typu A.

Redundant odwołuje się

adam-wyluda · 2017-01-11T16:53:54Z

Thank you @Krever for your review. I've added your suggestions to the translation, it's definitely much better now!

SethTisue · 2017-02-08T16:59:13Z

no other reviewer has appeared, so let's just merge. it can always be improved further again. thanks again!

adam-wyluda · 2017-02-08T18:15:34Z

For some reason there is no link to it in language list on the right side, but I can see that it's deployed now. Is there something else I should add to make it available? It worked fine when I was running it on my machine.

SethTisue · 2017-02-09T17:33:33Z

hopefully fixed in dca716f once it finishes deploying. if not let me know

SethTisue · 2017-02-10T22:34:20Z

fix is not live, because #680

mpociecha · 2017-02-10T22:50:47Z

pl/tutorials/tour/abstract-types.md

+tutorial-previous: inner-classes
+---
+
+W Scali, klasy są parametryzowane wartościami (parametry konstruktora) oraz typami (jeżeli klasa jest [generyczna](generic-classes.html)). Aby zachować regularność, zarówno typy jak i wartości są elementami klasy. Analogicznie mogą one być konkretne albo abstrakcyjne.


There shouldn't be , after Scali, tbh.

mpociecha · 2017-02-10T22:52:50Z

pl/tutorials/tour/abstract-types.md

+}
+```
+
+Cechy oraz [klasy](classes.html) z abstrakcyjnymi typami są często używane w połączeniu z anonimowymi klasami. Aby to zilustrować wykorzystamy program, w którym utworzymy bufor sekwencji ograniczony do listy liczb całkowitych:


I would consider adding comma after zilustrować.

mpociecha · 2017-02-10T22:53:40Z

pl/tutorials/tour/abstract-types.md

+
+Typ zwracany przez metodę `newIntSeqBuf` nawiązuje do specjalizacji cechy `Buffer`, w której typ `U` jest równy `Int`. Podobnie w anonimowej klasie tworzonej w metodzie `newIntSeqBuf` określamy `T` jako `List[Int]`.
+
+Warto zwrócić uwagę na to, że często jest możliwa zamiana abstrakcyjnych typów w parametry typów klas i odwrotnie. Poniższy przykład stosuje wyłącznie parametry typów:


Without na to it would sound better,

mpociecha · 2017-02-10T22:55:03Z

pl/tutorials/tour/annotations.md

+
+Adnotację stosuje się do pierwszej definicji lub deklaracji która po niej następuje. Możliwe jest zastosowanie więcej niż jednej adnotacji przed definicją lub deklaracją. Kolejność według której są one określone nie ma istotnego znaczenia.
+
+Znaczenie adnotacji jest zależne od implementacji. Na platformie Java, poniższe adnotacje domyślnie oznaczają:


There shouldn't be comma after Java.

mpociecha · 2017-02-10T22:56:10Z

pl/tutorials/tour/annotations.md

+public class MyClass extends HisClass ...
+```
+
+W tym przypadku, Scala daje taką samą możliwość:


Without comma after przypadku.

mpociecha · 2017-02-10T23:00:01Z

pl/tutorials/tour/case-classes.md

+SMS is: SMS(12345, Hello!)
+```
+
+Jednym z najważniejszych zastosowań klas przypadków (skąd też się wzięła ich nazwa), jest **dopasowanie wzorca**. Poniższy przykład pokazuje działanie funkcji, która zwraca różne komunikaty, w zależności od rodzaju powiadomienia:


Without comma before jest.

And also I wouldn't insert it after komunikaty.

mpociecha · 2017-02-10T23:01:46Z

pl/tutorials/tour/case-classes.md

+
+```
+
+Programując w Scali, zachęca się abyś jak najszerzej używał klas przypadków do modelowania danych, jako że kod który je wykorzystuje jest bardziej ekspresywny i łatwiejszy do utrzymania:


wykorzystujący je kod or kod, który je wykorzystuje, jest bardziej

mpociecha · 2017-02-10T23:02:27Z

pl/tutorials/tour/case-classes.md

+Programując w Scali, zachęca się abyś jak najszerzej używał klas przypadków do modelowania danych, jako że kod który je wykorzystuje jest bardziej ekspresywny i łatwiejszy do utrzymania:
+
+* Obiekty niemutowalne uwalniają cię od potrzeby śledzenia zmian stanu
+* Porównanie przez wartość pozwala na porównywanie instancji tak jakby były prymitywnymi wartościami


There's needed a comma somewhere. Likely before jakby.

mpociecha · 2017-02-10T23:04:49Z

pl/tutorials/tour/classes.md

+}
+```
+
+Program definiuje wykonywalną aplikację w postaci [obiektu singleton](singleton-objects.html) z główną metodą `main`. Metoda `main` tworzy nową instancję typu `Point` i zapisuje ją do wartości `pt`. Istotną rzeczą jest to, że wartości zdefiniowane z użyciem słowa kluczowego `val` różnią się od zmiennych określonych przez `var` (jak w klasie `Point` powyżej), tym że nie dopuszczają aktualizacji ich wartości.


Comma should be before że, not before tym.

mpociecha · 2017-02-10T23:08:40Z

pl/tutorials/tour/extractor-objects.md

+tutorial-previous: regular-expression-patterns
+---
+
+W Scali, wzorce mogą być zdefiniowane niezależnie od klas przypadków. Obiekt posiadający metodę `unapply` może funkcjonować jako tak zwany ekstraktor. Jest to szczególna metoda, która pozwala na odwrócenie zastosowania obiektu dla pewnych danych. Jego celem jest ekstrakcja danych, z których został on utworzony. Dla przykładu, poniższy kod definiuje ekstraktor dla [obiektu](singleton-objects.html) `Twice`:


Without comma after Scali.

mpociecha · 2017-02-10T23:11:41Z

I know I'm late to the party (too late). But I quickly and briefly looked through the part of translated files. You can take this into account in case of some follow-up PR, if you want. :)

And, personally, to me it's a bit strange to read technical stuff in Polish. ;) Esp. that it's anyway Polish - English - PolGlish mix (it has to be like that). :)

But there was quite a lot of things to translate so really good job!

Edit: I can take a look at the rest of files but not now. And I'm looking rather at the wording and the punctuation than at the general context.

mpociecha · 2017-02-10T23:39:42Z

Seth, it's hard to expect that reviewers will appear without the explicit invitation in case of (no offense :) ) such a niche repo as scala.github.com. ;)

SethTisue · 2017-02-10T23:49:17Z

iirc, I did ask for reviewers on Gitter.

Is there some other way we should have publicized it? I don't think it quite rises to the level where it makes sense for scala_lang to tweet about it.

in general, on translations, it's usually the submitter who has the best chance of bringing in reviewers themselves, since they know people in their own language community.

mpociecha · 2017-02-11T00:11:16Z

"I did ask for reviewers on Gitter." I didn't know. And it is what I meant by the invitation.
Yes, I agree.

SethTisue · 2017-02-11T00:14:55Z

in general, I think all of us — but especially the Scala team — could do more to alert the community to PRs that need a little love. I do it maybe once a week on Gitter, but I could probably be doing more like once a day. I'll try to keep it in mind.

I sometimes wonder if there ought to be a more regular and/or formal channel for this. maybe a weekly “help wanted” post to contributors.scala-lang.org, something like that. idk

som-snytt · 2017-02-11T01:41:53Z

Maybe ask on gitter.PL. But gitter is ephemeral. I can't follow convos beyond a brief exchange. I wanted to keep up with gitter channels in 2017, but whenever I check, they're all maxed out at 100 messages of history. I like the idea of an automated reminder, of the sort that have always been sent to mailing lists, once a week, to the gitter channel, of moribund PRs, i.e., those which have been unloved for the entire week.

The bot could also single out a random user to ask, Hey, @ Jo, would you be interested in helping with a PR? That would be so embarrassing and so great.

adam-wyluda · 2017-02-11T12:27:43Z

@mpociecha Thanks for having a look at this, I'm really poor at punctuation :). I'll apply your suggestions soon in another PR (maybe along with translation of the new Basics page).

mpociecha · 2017-02-11T18:56:48Z

@adamwy In meantime I'll finish reading this one since I was somewhere in the middle, I think. :)

In case of Basics or other future translations you can ping me. It may be definitely more effective if I'll create PRs against your branches with suggested fixes to punctuation instead of forcing you to apply each of them manually. ;)

mpociecha · 2017-02-11T21:07:58Z

@adamwy Honestly, finally I realised (better late than never ;) ) that it doesn't make sense to add comments to the already merged PR. I'll just create PR with my suggestions and will "add" you as a reviewer.

Polish translation of the Scala tutorial

61e4ed5

adam-wyluda added 2 commits January 10, 2017 12:25

Fix example code example in explicitly-typed-self-references.md and s…

7e5fe32

…everal minor corrections

Fix some typos

f9b3f6d

Krever reviewed Jan 11, 2017

View reviewed changes

Add improvements to the translation

1ec6c96

SethTisue merged commit a018c28 into scala:master Feb 8, 2017

mpociecha reviewed Feb 10, 2017

View reviewed changes


		Scala wspiera mechanizm _klas case_. Klasy case są zwykłymi klasami z dodatkowymi założeniami:

		* Domyślnie immutable


		## Companion ##

		Duża część obiektów singleton nie istnieje samodzielnie, ale jest powiązana z klasą o tej samej nazwie. Obiekt singleton generowany dla klasy case jest tego przykładem. Kiedy tak się dzieje, obiekt singleton jest zwany obiektem companion (co oznacza, że jest _towarzyszem_ tej klasy).


		Typ zwracany przez metodę `newIntSeqBuf` nawiązuje do specjalizacji cechy `Buffer`, w której typ `U` jest równy `Int`. Podobnie w anonimowej klasie tworzonej w metodzie `newIntSeqBuf` określamy `T` jako `List[Int]`.

		Warto zwrócić uwagę na to, że często jest możliwa zamiana abstrakcyjnych typów w parametry typów klas i odwrotnie. Poniższy przykład stosuje wyłącznie parametry typów:


		Adnotację stosuje się do pierwszej definicji lub deklaracji która po niej następuje. Możliwe jest zastosowanie więcej niż jednej adnotacji przed definicją lub deklaracją. Kolejność według której są one określone nie ma istotnego znaczenia.

		Znaczenie adnotacji jest zależne od implementacji. Na platformie Java, poniższe adnotacje domyślnie oznaczają:


		```

		Programując w Scali, zachęca się abyś jak najszerzej używał klas przypadków do modelowania danych, jako że kod który je wykorzystuje jest bardziej ekspresywny i łatwiejszy do utrzymania:

Polish translation of the Scala tutorial #652

Polish translation of the Scala tutorial #652

Conversation

adam-wyluda commented Jan 10, 2017

heathermiller commented Jan 10, 2017

Krever left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

adam-wyluda commented Jan 11, 2017

SethTisue commented Feb 8, 2017

adam-wyluda commented Feb 8, 2017

SethTisue commented Feb 9, 2017

SethTisue commented Feb 10, 2017

Choose a reason for hiding this comment

mpociecha Feb 10, 2017 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mpociecha Feb 10, 2017 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mpociecha commented Feb 10, 2017 • edited Loading

mpociecha commented Feb 10, 2017

SethTisue commented Feb 10, 2017

mpociecha commented Feb 11, 2017 • edited Loading

SethTisue commented Feb 11, 2017

som-snytt commented Feb 11, 2017

adam-wyluda commented Feb 11, 2017 • edited Loading

mpociecha commented Feb 11, 2017

mpociecha commented Feb 11, 2017 • edited Loading

mpociecha Feb 10, 2017 •

edited

Loading

mpociecha Feb 10, 2017 •

edited

Loading

mpociecha commented Feb 10, 2017 •

edited

Loading

mpociecha commented Feb 11, 2017 •

edited

Loading

adam-wyluda commented Feb 11, 2017 •

edited

Loading

mpociecha commented Feb 11, 2017 •

edited

Loading